/ Developer CD Series 1996 March: Reference Library / Dev.CD Mar 96 RL / Dev.CD Mar 96 RL.toast / Technical Documentation / develop / develop Issue 24 / develop Issue 24 code / Scriptable Database 1.0a11.sea / Scriptable Database 1.0a11 / Database / TransactionAwareObject.h

< prev

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 18 54 72 61 6e 73 61 | 63 74 69 6f 6e 41 77 61 |..Transa|ctionAwa|
|00000010| 72 65 4f 62 6a 65 63 74 | 2e 68 00 00 00 00 00 00 |reObject|.h......|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 4d 4d 43 | 43 01 00 00 00 00 00 00 |.TEXTMMC|C.......|
|00000050| 00 00 00 00 00 13 f6 00 | 00 01 9a ac ba f8 c5 ac |........|........|
|00000060| ba f8 c5 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 32 47 00 00 |........|....2G..|
|00000080| 2f 2f 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |//======|========|
|00000090| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000a0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000b0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000c0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000000d0| 3d 3d 0d 2f 2f 20 47 72 | 65 67 20 41 6e 64 65 72 |==.// Gr|eg Ander|
|000000e0| 73 6f 6e 0d 2f 2f 20 64 | 62 2b 0d 2f 2f 0d 2f 2f |son.// d|b+.//.//|
|000000f0| 20 41 62 73 74 72 61 63 | 74 20 62 61 73 65 20 63 | Abstrac|t base c|
|00000100| 6c 61 73 73 20 66 6f 72 | 20 6f 62 6a 65 63 74 73 |lass for| objects|
|00000110| 20 74 68 61 74 20 63 61 | 6e 20 68 61 76 65 20 75 | that ca|n have u|
|00000120| 70 64 61 74 65 20 70 6f | 69 6e 74 65 72 73 2c 20 |pdate po|inters, |
|00000130| 70 61 72 74 69 63 69 70 | 61 74 65 0d 2f 2f 20 69 |particip|ate.// i|
|00000140| 6e 20 74 72 61 6e 73 61 | 63 74 69 6f 6e 73 2c 20 |n transa|ctions, |
|00000150| 61 6e 64 20 73 6f 20 6f | 6e 2e 0d 2f 2f 20 31 36 |and so o|n..// 16|
|00000160| 2c 20 31 37 20 4d 61 79 | 20 31 39 39 34 0d 2f 2f |, 17 May| 1994.//|
|00000170| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000180| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000190| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000001a0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000001b0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000001c0| 0d 23 70 72 61 67 6d 61 | 20 6f 6e 63 65 0d 0d 23 |.#pragma| once..#|
|000001d0| 69 66 6e 64 65 66 20 5f | 5f 54 52 41 4e 53 41 43 |ifndef _|_TRANSAC|
|000001e0| 54 49 4f 4e 41 57 41 52 | 45 4f 42 4a 45 43 54 5f |TIONAWAR|EOBJECT_|
|000001f0| 5f 0d 23 64 65 66 69 6e | 65 20 5f 5f 54 52 41 4e |_.#defin|e __TRAN|
|00000200| 53 41 43 54 49 4f 4e 41 | 57 41 52 45 4f 42 4a 45 |SACTIONA|WAREOBJE|
|00000210| 43 54 5f 5f 0d 0d 23 69 | 6e 63 6c 75 64 65 20 22 |CT__..#i|nclude "|
|00000220| 49 6e 74 36 34 2e 68 22 | 0d 0d 63 6c 61 73 73 20 |Int64.h"|..class |
|00000230| 54 54 72 61 6e 73 61 63 | 74 69 6f 6e 3b 0d 2f 2f |TTransac|tion;.//|
|00000240| 20 63 6c 61 73 73 20 54 | 41 62 73 74 72 61 63 74 | class T|Abstract|
|00000250| 55 70 64 61 74 65 50 6f | 69 6e 74 65 72 3b 0d 0d |UpdatePo|inter;..|
|00000260| 63 6c 61 73 73 20 54 44 | 42 52 65 63 6f 72 64 3b |class TD|BRecord;|
|00000270| 0d 63 6c 61 73 73 20 54 | 44 42 45 6c 65 6d 65 6e |.class T|DBElemen|
|00000280| 74 3b 0d 63 6c 61 73 73 | 20 54 44 42 50 72 6f 70 |t;.class| TDBProp|
|00000290| 65 72 74 79 3b 0d 63 6c | 61 73 73 20 54 44 61 74 |erty;.cl|ass TDat|
|000002a0| 61 52 65 63 6f 72 64 3b | 0d 0d 63 6f 6e 73 74 20 |aRecord;|..const |
|000002b0| 4f 53 45 72 72 20 65 41 | 6c 72 65 61 64 79 49 6e |OSErr eA|lreadyIn|
|000002c0| 54 72 61 6e 73 61 63 74 | 69 6f 6e 20 3d 20 2d 33 |Transact|ion = -3|
|000002d0| 31 32 32 32 3b 0d 63 6f | 6e 73 74 20 4f 53 45 72 |1222;.co|nst OSEr|
|000002e0| 72 20 65 4e 6f 74 49 6e | 54 72 61 6e 73 61 63 74 |r eNotIn|Transact|
|000002f0| 69 6f 6e 20 3d 20 2d 33 | 31 32 32 33 3b 0d 0d 23 |ion = -3|1223;..#|
|00000300| 64 65 66 69 6e 65 20 6b | 4e 6f 54 72 61 6e 73 61 |define k|NoTransa|
|00000310| 63 74 69 6f 6e 20 6e 69 | 6c 0d 0d 2f 2f 3d 3d 3d |ction ni|l..//===|
|00000320| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000330| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000340| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000350| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000360| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 0d 2f 2f |========|=====.//|
|00000370| 20 63 6c 61 73 73 20 54 | 54 72 61 6e 73 61 63 74 | class T|Transact|
|00000380| 69 6f 6e 42 61 73 65 4f | 62 6a 65 63 74 0d 2f 2f |ionBaseO|bject.//|
|00000390| 0d 2f 2f 20 42 6f 74 68 | 20 75 70 64 61 74 65 20 |.// Both| update |
|000003a0| 70 6f 69 6e 74 65 72 73 | 20 61 6e 64 20 74 72 61 |pointers| and tra|
|000003b0| 6e 73 61 63 74 69 6f 6e | 2d 61 77 61 72 65 20 6f |nsaction|-aware o|
|000003c0| 62 6a 65 63 74 73 20 61 | 72 65 20 64 65 72 69 76 |bjects a|re deriv|
|000003d0| 65 64 20 66 72 6f 6d 0d | 2f 2f 20 74 68 65 20 63 |ed from.|// the c|
|000003e0| 6c 61 73 73 20 54 54 72 | 61 6e 73 61 63 74 69 6f |lass TTr|ansactio|
|000003f0| 6e 42 61 73 65 4f 62 6a | 65 63 74 2e 0d 2f 2f 3d |nBaseObj|ect..//=|
|00000400| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000410| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000420| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000430| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000440| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 0d |========|=======.|
|00000450| 63 6c 61 73 73 20 54 54 | 72 61 6e 73 61 63 74 69 |class TT|ransacti|
|00000460| 6f 6e 42 61 73 65 4f 62 | 6a 65 63 74 0d 7b 0d 70 |onBaseOb|ject.{.p|
|00000470| 72 69 76 61 74 65 3a 0d | 09 6c 6f 6e 67 09 09 09 |rivate:.|.long...|
|00000480| 09 09 09 66 52 65 66 65 | 72 65 6e 63 65 43 6f 75 |...fRefe|renceCou|
|00000490| 6e 74 3b 0d 09 0d 70 75 | 62 6c 69 63 3a 0d 09 09 |nt;...pu|blic:...|
|000004a0| 09 54 54 72 61 6e 73 61 | 63 74 69 6f 6e 42 61 73 |.TTransa|ctionBas|
|000004b0| 65 4f 62 6a 65 63 74 28 | 29 20 3a 20 66 52 65 66 |eObject(|) : fRef|
|000004c0| 65 72 65 6e 63 65 43 6f | 75 6e 74 28 30 29 20 7b |erenceCo|unt(0) {|
|000004d0| 7d 3b 0d 09 76 69 72 74 | 75 61 6c 09 7e 54 54 72 |};..virt|ual.~TTr|
|000004e0| 61 6e 73 61 63 74 69 6f | 6e 42 61 73 65 4f 62 6a |ansactio|nBaseObj|
|000004f0| 65 63 74 28 29 20 7b 7d | 3b 0d 0d 09 2f 2f 0d 09 |ect() {}|;...//..|
|00000500| 2f 2f 20 54 68 65 20 6f | 62 6a 65 63 74 20 6b 65 |// The o|bject ke|
|00000510| 79 20 61 6e 64 20 6f 62 | 6a 65 63 74 20 6b 65 79 |y and ob|ject key|
|00000520| 20 73 70 61 63 65 20 61 | 72 65 20 75 73 65 64 20 | space a|re used |
|00000530| 74 6f 20 75 6e 69 71 75 | 65 6c 79 0d 09 2f 2f 20 |to uniqu|ely..// |
|00000540| 64 65 66 69 6e 65 20 61 | 6e 20 6f 62 6a 65 63 74 |define a|n object|
|00000550| 2c 20 73 6f 20 74 68 61 | 74 20 61 20 74 72 61 6e |, so tha|t a tran|
|00000560| 73 61 63 74 69 6f 6e 20 | 6d 61 79 20 64 65 74 65 |saction |may dete|
|00000570| 72 6d 69 6e 65 20 69 66 | 0d 09 2f 2f 20 69 74 20 |rmine if|..// it |
|00000580| 61 6c 72 65 61 64 79 20 | 68 61 73 20 61 6e 20 75 |already |has an u|
|00000590| 70 64 61 74 65 20 70 6f | 69 6e 74 65 72 20 66 6f |pdate po|inter fo|
|000005a0| 72 20 61 20 67 69 76 65 | 6e 20 6f 62 6a 65 63 74 |r a give|n object|
|000005b0| 2e 0d 09 2f 2f 20 0d 09 | 76 69 72 74 75 61 6c 20 |...// ..|virtual |
|000005c0| 49 6e 74 36 34 09 09 09 | 09 4f 62 6a 65 63 74 73 |Int64...|.Objects|
|000005d0| 4b 65 79 53 70 61 63 65 | 28 29 20 63 6f 6e 73 74 |KeySpace|() const|
|000005e0| 20 3d 20 30 3b 0d 09 76 | 69 72 74 75 61 6c 20 6c | = 0;..v|irtual l|
|000005f0| 6f 6e 67 09 09 09 09 4f | 62 6a 65 63 74 4b 65 79 |ong....O|bjectKey|
|00000600| 28 29 20 63 6f 6e 73 74 | 20 3d 20 30 3b 0d 09 0d |() const| = 0;...|
|00000610| 09 2f 2f 0d 09 2f 2f 20 | 43 6f 6e 76 65 6e 69 65 |.//..// |Convenie|
|00000620| 6e 63 65 20 66 75 6e 63 | 74 69 6f 6e 20 66 6f 72 |nce func|tion for|
|00000630| 20 63 6f 6d 70 61 72 69 | 6e 67 20 6b 65 79 73 3a | compari|ng keys:|
|00000640| 0d 09 2f 2f 0d 09 42 6f | 6f 6c 65 61 6e 09 09 09 |..//..Bo|olean...|
|00000650| 09 09 09 4b 65 79 73 4d | 61 74 63 68 28 63 6f 6e |...KeysM|atch(con|
|00000660| 73 74 20 54 54 72 61 6e | 73 61 63 74 69 6f 6e 42 |st TTran|sactionB|
|00000670| 61 73 65 4f 62 6a 65 63 | 74 26 20 74 65 73 74 29 |aseObjec|t& test)|
|00000680| 20 63 6f 6e 73 74 0d 09 | 09 09 09 09 09 09 09 7b | const..|.......{|
|00000690| 0d 09 09 09 09 09 09 09 | 09 09 72 65 74 75 72 6e |........|..return|
|000006a0| 20 28 74 68 69 73 2d 3e | 4f 62 6a 65 63 74 73 4b | (this->|ObjectsK|
|000006b0| 65 79 53 70 61 63 65 28 | 29 20 3d 3d 20 74 65 73 |eySpace(|) == tes|
|000006c0| 74 2e 4f 62 6a 65 63 74 | 73 4b 65 79 53 70 61 63 |t.Object|sKeySpac|
|000006d0| 65 28 29 29 20 26 26 20 | 28 74 68 69 73 2d 3e 4f |e()) && |(this->O|
|000006e0| 62 6a 65 63 74 4b 65 79 | 28 29 20 3d 3d 20 74 65 |bjectKey|() == te|
|000006f0| 73 74 2e 4f 62 6a 65 63 | 74 4b 65 79 28 29 29 3b |st.Objec|tKey());|
|00000700| 0d 09 09 09 09 09 09 09 | 09 7d 3b 0d 0d 0d 2f 2f |........|.};...//|
|00000710| 09 76 6f 69 64 09 09 09 | 09 09 09 41 64 64 52 65 |.void...|...AddRe|
|00000720| 66 65 72 65 6e 63 65 28 | 29 20 63 6f 6e 73 74 09 |ference(|) const.|
|00000730| 09 09 7b 20 2b 2b 28 28 | 54 54 72 61 6e 73 61 63 |..{ ++((|TTransac|
|00000740| 74 69 6f 6e 42 61 73 65 | 4f 62 6a 65 63 74 2a 29 |tionBase|Object*)|
|00000750| 74 68 69 73 29 2d 3e 66 | 52 65 66 65 72 65 6e 63 |this)->f|Referenc|
|00000760| 65 43 6f 75 6e 74 3b 20 | 7d 0d 2f 2f 09 76 6f 69 |eCount; |}.//.voi|
|00000770| 64 09 09 09 09 09 09 52 | 65 6d 6f 76 65 52 65 66 |d......R|emoveRef|
|00000780| 65 72 65 6e 63 65 28 29 | 20 63 6f 6e 73 74 09 09 |erence()| const..|
|00000790| 09 7b 20 2d 2d 28 28 54 | 54 72 61 6e 73 61 63 74 |.{ --((T|Transact|
|000007a0| 69 6f 6e 42 61 73 65 4f | 62 6a 65 63 74 2a 29 74 |ionBaseO|bject*)t|
|000007b0| 68 69 73 29 2d 3e 66 52 | 65 66 65 72 65 6e 63 65 |his)->fR|eference|
|000007c0| 43 6f 75 6e 74 3b 20 7d | 3b 0d 09 76 69 72 74 75 |Count; }|;..virtu|
|000007d0| 61 6c 20 76 6f 69 64 09 | 09 09 09 41 64 64 52 65 |al void.|...AddRe|
|000007e0| 66 65 72 65 6e 63 65 28 | 29 20 63 6f 6e 73 74 3b |ference(|) const;|
|000007f0| 0d 09 76 69 72 74 75 61 | 6c 20 42 6f 6f 6c 65 61 |..virtua|l Boolea|
|00000800| 6e 09 09 09 09 52 65 6d | 6f 76 65 52 65 66 65 72 |n....Rem|oveRefer|
|00000810| 65 6e 63 65 28 29 20 63 | 6f 6e 73 74 3b 0d 09 42 |ence() c|onst;..B|
|00000820| 6f 6f 6c 65 61 6e 09 09 | 09 09 09 09 48 61 73 52 |oolean..|....HasR|
|00000830| 65 66 65 72 65 6e 63 65 | 28 29 20 63 6f 6e 73 74 |eference|() const|
|00000840| 09 09 09 7b 20 72 65 74 | 75 72 6e 20 66 52 65 66 |...{ ret|urn fRef|
|00000850| 65 72 65 6e 63 65 43 6f | 75 6e 74 20 3e 20 30 3b |erenceCo|unt > 0;|
|00000860| 20 7d 0d 0d 09 2f 2f 0d | 09 2f 2f 20 44 65 6c 65 | }...//.|.// Dele|
|00000870| 74 65 20 74 68 69 73 20 | 69 66 20 77 65 20 63 61 |te this |if we ca|
|00000880| 6e 0d 09 2f 2f 0d 09 76 | 69 72 74 75 61 6c 20 76 |n..//..v|irtual v|
|00000890| 6f 69 64 09 09 09 09 44 | 69 73 70 6f 73 65 52 65 |oid....D|isposeRe|
|000008a0| 63 6f 72 64 49 66 55 6e | 72 65 66 65 72 65 6e 63 |cordIfUn|referenc|
|000008b0| 65 64 28 29 3b 0d 09 0d | 70 72 6f 74 65 63 74 65 |ed();...|protecte|
|000008c0| 64 3a 0d 09 2f 2f 0d 09 | 2f 2f 20 41 20 74 72 61 |d:..//..|// A tra|
|000008d0| 6e 73 61 63 74 69 6f 6e | 20 77 69 6c 6c 20 63 61 |nsaction| will ca|
|000008e0| 6c 6c 20 65 69 74 68 65 | 72 20 63 6f 6d 6d 69 74 |ll eithe|r commit|
|000008f0| 20 63 68 61 6e 67 65 73 | 20 6f 72 20 64 69 73 63 | changes| or disc|
|00000900| 61 72 64 20 63 68 61 6e | 67 65 73 2c 0d 09 2f 2f |ard chan|ges,..//|
|00000910| 20 62 75 74 20 6e 65 76 | 65 72 20 62 6f 74 68 2e | but nev|er both.|
|00000920| 0d 09 2f 2f 0d 09 76 69 | 72 74 75 61 6c 20 76 6f |..//..vi|rtual vo|
|00000930| 69 64 09 09 09 09 50 72 | 65 70 61 72 65 54 6f 43 |id....Pr|epareToC|
|00000940| 6f 6d 6d 69 74 28 54 54 | 72 61 6e 73 61 63 74 69 |ommit(TT|ransacti|
|00000950| 6f 6e 2a 20 74 72 61 6e | 73 61 63 74 69 6f 6e 29 |on* tran|saction)|
|00000960| 3b 0d 09 76 69 72 74 75 | 61 6c 20 76 6f 69 64 09 |;..virtu|al void.|
|00000970| 09 09 09 43 6f 6d 6d 69 | 74 43 68 61 6e 67 65 73 |...Commi|tChanges|
|00000980| 28 54 54 72 61 6e 73 61 | 63 74 69 6f 6e 2a 20 74 |(TTransa|ction* t|
|00000990| 72 61 6e 73 61 63 74 69 | 6f 6e 29 20 3d 20 30 3b |ransacti|on) = 0;|
|000009a0| 0d 09 76 69 72 74 75 61 | 6c 20 76 6f 69 64 09 09 |..virtua|l void..|
|000009b0| 09 09 44 69 73 63 61 72 | 64 43 68 61 6e 67 65 73 |..Discar|dChanges|
|000009c0| 28 54 54 72 61 6e 73 61 | 63 74 69 6f 6e 2a 20 74 |(TTransa|ction* t|
|000009d0| 72 61 6e 73 61 63 74 69 | 6f 6e 29 20 3d 20 30 3b |ransacti|on) = 0;|
|000009e0| 0d 7d 3b 0d 0d 2f 2f 3d | 3d 3d 3d 3d 3d 3d 3d 3d |.};..//=|========|
|000009f0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000a00| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000a10| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000a20| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000a30| 3d 3d 3d 3d 3d 3d 3d 0d | 2f 2f 20 63 6c 61 73 73 |=======.|// class|
|00000a40| 20 54 54 72 61 6e 73 61 | 63 74 69 6f 6e 41 77 61 | TTransa|ctionAwa|
|00000a50| 72 65 4f 62 6a 65 63 74 | 0d 2f 2f 0d 2f 2f 20 41 |reObject|.//.// A|
|00000a60| 6e 79 20 6f 62 6a 65 63 | 74 20 74 68 61 74 20 63 |ny objec|t that c|
|00000a70| 61 6e 20 63 72 65 61 74 | 65 20 61 6e 20 75 70 64 |an creat|e an upd|
|00000a80| 61 74 65 20 70 6f 69 6e | 74 65 72 20 61 6e 64 20 |ate poin|ter and |
|00000a90| 62 65 20 70 61 72 74 20 | 6f 66 20 61 20 74 72 61 |be part |of a tra|
|00000aa0| 6e 73 61 63 74 69 6f 6e | 0d 2f 2f 20 69 73 20 64 |nsaction|.// is d|
|00000ab0| 65 72 69 76 65 64 20 66 | 72 6f 6d 20 74 68 65 20 |erived f|rom the |
|00000ac0| 63 6c 61 73 73 20 54 54 | 72 61 6e 73 61 63 74 69 |class TT|ransacti|
|00000ad0| 6f 6e 41 77 61 72 65 4f | 62 6a 65 63 74 0d 2f 2f |onAwareO|bject.//|
|00000ae0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000af0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000b00| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000b10| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000b20| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000b30| 0d 63 6c 61 73 73 20 54 | 54 72 61 6e 73 61 63 74 |.class T|Transact|
|00000b40| 69 6f 6e 41 77 61 72 65 | 4f 62 6a 65 63 74 20 3a |ionAware|Object :|
|00000b50| 20 70 75 62 6c 69 63 20 | 54 54 72 61 6e 73 61 63 | public |TTransac|
|00000b60| 74 69 6f 6e 42 61 73 65 | 4f 62 6a 65 63 74 0d 7b |tionBase|Object.{|
|00000b70| 0d 09 2f 2f 0d 09 2f 2f | 20 54 54 72 61 6e 73 61 |..//..//| TTransa|
|00000b80| 63 74 69 6f 6e 20 69 73 | 20 61 20 66 72 69 65 6e |ction is| a frien|
|00000b90| 64 20 63 6c 61 73 73 20 | 62 65 63 61 75 73 65 20 |d class |because |
|00000ba0| 6f 6e 6c 79 20 74 68 65 | 20 74 72 61 6e 73 61 63 |only the| transac|
|00000bb0| 74 69 6f 6e 0d 09 2f 2f | 20 69 73 20 61 6c 6c 6f |tion..//| is allo|
|00000bc0| 77 65 64 20 74 6f 20 61 | 73 6b 20 66 6f 72 20 74 |wed to a|sk for t|
|00000bd0| 68 65 20 75 70 64 61 74 | 65 20 70 6f 69 6e 74 65 |he updat|e pointe|
|00000be0| 72 20 66 6f 72 20 61 6e | 20 6f 62 6a 65 63 74 2e |r for an| object.|
|00000bf0| 0d 09 2f 2f 0d 09 66 72 | 69 65 6e 64 20 63 6c 61 |..//..fr|iend cla|
|00000c00| 73 73 20 54 54 72 61 6e | 73 61 63 74 69 6f 6e 3b |ss TTran|saction;|
|00000c10| 0d 0d 70 72 69 76 61 74 | 65 3a 0d 09 54 54 72 61 |..privat|e:..TTra|
|00000c20| 6e 73 61 63 74 69 6f 6e | 2a 09 09 09 09 66 54 72 |nsaction|*....fTr|
|00000c30| 61 6e 73 61 63 74 69 6f | 6e 3b 0d 09 0d 70 75 62 |ansactio|n;...pub|
|00000c40| 6c 69 63 3a 0d 09 09 09 | 54 54 72 61 6e 73 61 63 |lic:....|TTransac|
|00000c50| 74 69 6f 6e 41 77 61 72 | 65 4f 62 6a 65 63 74 28 |tionAwar|eObject(|
|00000c60| 29 20 3a 20 66 54 72 61 | 6e 73 61 63 74 69 6f 6e |) : fTra|nsaction|
|00000c70| 28 6e 69 6c 29 20 7b 7d | 3b 0d 09 76 69 72 74 75 |(nil) {}|;..virtu|
|00000c80| 61 6c 20 7e 54 54 72 61 | 6e 73 61 63 74 69 6f 6e |al ~TTra|nsaction|
|00000c90| 41 77 61 72 65 4f 62 6a | 65 63 74 28 29 20 7b 7d |AwareObj|ect() {}|
|00000ca0| 3b 0d 09 0d 09 42 6f 6f | 6c 65 61 6e 09 09 09 09 |;....Boo|lean....|
|00000cb0| 09 09 49 6e 54 72 61 6e | 73 61 63 74 69 6f 6e 28 |..InTran|saction(|
|00000cc0| 29 20 63 6f 6e 73 74 20 | 7b 20 72 65 74 75 72 6e |) const |{ return|
|00000cd0| 20 66 54 72 61 6e 73 61 | 63 74 69 6f 6e 20 21 3d | fTransa|ction !=|
|00000ce0| 20 6e 69 6c 3b 20 7d 3b | 0d 09 42 6f 6f 6c 65 61 | nil; };|..Boolea|
|00000cf0| 6e 09 09 09 09 09 09 49 | 6e 54 72 61 6e 73 61 63 |n......I|nTransac|
|00000d00| 74 69 6f 6e 28 54 54 72 | 61 6e 73 61 63 74 69 6f |tion(TTr|ansactio|
|00000d10| 6e 2a 20 74 29 20 63 6f | 6e 73 74 20 7b 20 72 65 |n* t) co|nst { re|
|00000d20| 74 75 72 6e 20 66 54 72 | 61 6e 73 61 63 74 69 6f |turn fTr|ansactio|
|00000d30| 6e 20 3d 3d 20 74 3b 20 | 7d 3b 0d 0d 09 2f 2f 0d |n == t; |};...//.|
|00000d40| 09 2f 2f 20 54 68 69 73 | 20 6d 65 74 68 6f 64 20 |.// This| method |
|00000d50| 73 68 6f 75 6c 64 20 72 | 65 61 6c 6c 79 20 62 65 |should r|eally be|
|00000d60| 20 70 72 6f 74 65 63 74 | 65 64 0d 09 2f 2f 0d 09 | protect|ed..//..|
|00000d70| 54 54 72 61 6e 73 61 63 | 74 69 6f 6e 2a 09 09 09 |TTransac|tion*...|
|00000d80| 09 54 72 61 6e 73 61 63 | 74 69 6f 6e 28 29 20 63 |.Transac|tion() c|
|00000d90| 6f 6e 73 74 20 7b 20 72 | 65 74 75 72 6e 20 66 54 |onst { r|eturn fT|
|00000da0| 72 61 6e 73 61 63 74 69 | 6f 6e 3b 20 7d 3b 0d 09 |ransacti|on; };..|
|00000db0| 0d 09 2f 2f 0d 09 2f 2f | 20 4f 62 6a 65 63 74 73 |..//..//| Objects|
|00000dc0| 20 74 68 61 74 20 63 61 | 6e 20 62 65 6c 6f 6e 67 | that ca|n belong|
|00000dd0| 20 74 6f 20 74 72 61 6e | 73 61 63 74 69 6f 6e 73 | to tran|sactions|
|00000de0| 20 6d 75 73 74 20 62 65 | 20 61 62 6c 65 0d 09 2f | must be| able../|
|00000df0| 2f 20 74 6f 20 63 72 65 | 61 74 65 20 61 6e 20 75 |/ to cre|ate an u|
|00000e00| 70 64 61 74 65 20 70 6f | 69 6e 74 65 72 20 61 6e |pdate po|inter an|
|00000e10| 64 20 63 6f 6d 6d 69 74 | 20 61 6e 64 20 64 69 73 |d commit| and dis|
|00000e20| 63 61 72 64 20 63 68 61 | 6e 67 65 73 3b 0d 09 2f |card cha|nges;../|
|00000e30| 2f 20 48 6f 77 65 76 65 | 72 2c 20 6f 6e 6c 79 20 |/ Howeve|r, only |
|00000e40| 74 68 65 69 72 20 66 72 | 69 65 6e 64 73 20 63 61 |their fr|iends ca|
|00000e50| 6e 20 61 73 6b 20 74 68 | 65 6d 20 74 6f 20 64 6f |n ask th|em to do|
|00000e60| 20 69 74 20 28 69 6e 20 | 74 68 69 73 0d 09 2f 2f | it (in |this..//|
|00000e70| 20 63 61 73 65 2c 20 6f | 6e 6c 79 20 61 20 74 72 | case, o|nly a tr|
|00000e80| 61 6e 73 61 63 74 69 6f | 6e 20 6f 62 6a 65 63 74 |ansactio|n object|
|00000e90| 20 77 69 6c 6c 20 63 61 | 6c 6c 20 74 68 65 73 65 | will ca|ll these|
|00000ea0| 20 6d 65 74 68 6f 64 73 | 29 2e 0d 09 2f 2f 0d 09 | methods|)...//..|
|00000eb0| 2f 2f 20 49 4d 50 4f 52 | 54 41 4e 54 3a 20 20 4e |// IMPOR|TANT:  N|
|00000ec0| 6f 74 65 20 74 68 61 74 | 20 74 68 65 20 66 6f 6c |ote that| the fol|
|00000ed0| 6c 6f 77 69 6e 67 20 6d | 65 74 68 6f 64 73 20 61 |lowing m|ethods a|
|00000ee0| 72 65 20 61 6c 6c 20 64 | 65 63 6c 61 72 65 64 0d |re all d|eclared.|
|00000ef0| 09 2f 2f 20 74 6f 20 62 | 65 20 27 63 6f 6e 73 74 |.// to b|e 'const|
|00000f00| 27 2c 20 65 76 65 6e 20 | 74 68 6f 75 67 68 20 74 |', even |though t|
|00000f10| 68 65 79 20 63 68 61 6e | 67 65 20 66 69 65 6c 64 |hey chan|ge field|
|00000f20| 73 20 6f 66 20 74 68 65 | 20 6f 62 6a 65 63 74 2e |s of the| object.|
|00000f30| 0d 09 2f 2f 20 49 74 20 | 69 73 20 76 65 72 79 20 |..// It |is very |
|00000f40| 69 6d 70 6f 72 74 61 6e | 74 20 74 68 61 74 20 74 |importan|t that t|
|00000f50| 68 65 73 65 20 6d 65 74 | 68 6f 64 73 20 62 65 20 |hese met|hods be |
|00000f60| 64 65 63 6c 61 72 65 64 | 20 63 6f 6e 73 74 20 73 |declared| const s|
|00000f70| 6f 20 0d 09 2f 2f 20 74 | 68 61 74 20 63 75 72 73 |o ..// t|hat curs|
|00000f80| 6f 72 73 20 77 69 74 68 | 20 63 6f 6e 73 74 2d 6f |ors with| const-o|
|00000f90| 6e 6c 79 20 61 63 63 65 | 73 73 20 63 61 6e 20 63 |nly acce|ss can c|
|00000fa0| 61 6c 6c 20 74 68 65 6d | 2e 20 20 49 74 20 69 73 |all them|.  It is|
|00000fb0| 6e 27 74 0d 09 2f 2f 20 | 74 6f 6f 20 74 65 72 72 |n't..// |too terr|
|00000fc0| 69 62 6c 65 20 74 6f 20 | 63 61 6c 6c 20 74 68 65 |ible to |call the|
|00000fd0| 73 65 20 6d 65 74 68 6f | 64 73 20 27 63 6f 6e 73 |se metho|ds 'cons|
|00000fe0| 74 27 2c 20 74 68 6f 75 | 67 68 2c 20 73 69 6e 63 |t', thou|gh, sinc|
|00000ff0| 65 20 74 68 65 79 0d 09 | 2f 2f 20 61 72 65 20 6f |e they..|// are o|
|00001000| 6e 6c 79 20 63 68 61 6e | 67 69 6e 67 20 63 61 63 |nly chan|ging cac|
|00001010| 68 65 64 20 72 65 66 65 | 72 65 6e 63 65 73 20 28 |hed refe|rences (|
|00001020| 74 6f 20 74 68 65 20 6f | 62 6a 65 63 74 27 73 20 |to the o|bject's |
|00001030| 74 72 61 6e 73 61 63 74 | 69 6f 6e 0d 09 2f 2f 20 |transact|ion..// |
|00001040| 61 6e 64 20 75 70 64 61 | 74 65 20 70 6f 69 6e 74 |and upda|te point|
|00001050| 65 72 29 2c 20 61 6e 64 | 20 61 72 65 20 6e 6f 74 |er), and| are not|
|00001060| 20 61 63 74 75 61 6c 6c | 79 20 63 68 61 6e 67 69 | actuall|y changi|
|00001070| 6e 67 20 74 68 65 20 73 | 74 61 74 65 0d 09 2f 2f |ng the s|tate..//|
|00001080| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 74 68 65 | of the |data the|
|00001090| 20 6f 62 6a 65 63 74 20 | 72 65 70 72 65 73 65 6e | object |represen|
|000010a0| 74 73 2e 0d 09 2f 2f 0d | 70 72 6f 74 65 63 74 65 |ts...//.|protecte|
|000010b0| 64 3a 0d 09 76 6f 69 64 | 09 09 09 09 09 09 09 53 |d:..void|.......S|
|000010c0| 65 74 54 72 61 6e 73 61 | 63 74 69 6f 6e 28 54 54 |etTransa|ction(TT|
|000010d0| 72 61 6e 73 61 63 74 69 | 6f 6e 2a 20 74 29 20 63 |ransacti|on* t) c|
|000010e0| 6f 6e 73 74 20 7b 20 28 | 28 54 54 72 61 6e 73 61 |onst { (|(TTransa|
|000010f0| 63 74 69 6f 6e 41 77 61 | 72 65 4f 62 6a 65 63 74 |ctionAwa|reObject|
|00001100| 2a 29 74 68 69 73 29 2d | 3e 66 54 72 61 6e 73 61 |*)this)-|>fTransa|
|00001110| 63 74 69 6f 6e 20 3d 20 | 74 3b 20 7d 0d 0d 09 2f |ction = |t; }.../|
|00001120| 2f 0d 09 2f 2f 20 47 72 | 61 62 55 70 64 61 74 65 |/..// Gr|abUpdate|
|00001130| 50 6f 69 6e 74 65 72 20 | 73 68 6f 75 6c 64 20 63 |Pointer |should c|
|00001140| 72 65 61 74 65 20 61 6e | 20 75 70 64 61 74 65 20 |reate an| update |
|00001150| 70 6f 69 6e 74 65 72 2c | 20 6f 72 20 66 61 69 6c |pointer,| or fail|
|00001160| 20 69 66 20 6f 6e 65 20 | 61 6c 72 65 61 64 79 20 | if one |already |
|00001170| 65 78 69 73 74 73 0d 09 | 2f 2f 20 47 65 74 55 70 |exists..|// GetUp|
|00001180| 64 61 74 65 50 6f 69 6e | 74 65 72 20 73 68 6f 75 |datePoin|ter shou|
|00001190| 6c 64 20 72 65 74 75 72 | 6e 20 74 68 65 20 75 70 |ld retur|n the up|
|000011a0| 64 61 74 65 20 70 6f 69 | 6e 74 65 72 20 74 68 61 |date poi|nter tha|
|000011b0| 74 20 61 6c 72 65 61 64 | 79 20 65 78 69 73 74 73 |t alread|y exists|
|000011c0| 20 66 6f 72 20 74 68 65 | 20 6f 62 6a 65 63 74 2c | for the| object,|
|000011d0| 20 69 66 20 61 6e 79 0d | 09 2f 2f 20 52 65 6c 65 | if any.|.// Rele|
|000011e0| 61 73 65 55 70 64 61 74 | 65 50 6f 69 6e 74 65 72 |aseUpdat|ePointer|
|000011f0| 20 69 73 20 63 61 6c 6c | 65 64 20 62 79 20 74 68 | is call|ed by th|
|00001200| 65 20 74 72 61 6e 73 61 | 63 74 69 6f 6e 20 61 66 |e transa|ction af|
|00001210| 74 65 72 20 43 6f 6d 6d | 69 74 43 68 61 6e 67 65 |ter Comm|itChange|
|00001220| 73 20 6f 72 20 44 69 73 | 63 61 72 64 43 68 61 6e |s or Dis|cardChan|
|00001230| 67 65 73 0d 09 2f 2f 20 | 69 73 20 63 61 6c 6c 65 |ges..// |is calle|
|00001240| 64 2c 20 62 75 74 20 62 | 65 66 6f 72 65 20 74 68 |d, but b|efore th|
|00001250| 65 20 75 70 64 61 74 65 | 20 70 6f 69 6e 74 65 72 |e update| pointer|
|00001260| 20 69 73 20 61 63 74 75 | 61 6c 6c 79 20 64 65 6c | is actu|ally del|
|00001270| 65 74 65 64 2e 0d 09 2f | 2f 0d 09 76 69 72 74 75 |eted.../|/..virtu|
|00001280| 61 6c 20 54 54 72 61 6e | 73 61 63 74 69 6f 6e 41 |al TTran|sactionA|
|00001290| 77 61 72 65 4f 62 6a 65 | 63 74 2a 09 47 72 61 62 |wareObje|ct*.Grab|
|000012a0| 55 70 64 61 74 65 50 6f | 69 6e 74 65 72 28 54 54 |UpdatePo|inter(TT|
|000012b0| 72 61 6e 73 61 63 74 69 | 6f 6e 2a 20 74 72 61 6e |ransacti|on* tran|
|000012c0| 73 61 63 74 69 6f 6e 29 | 20 63 6f 6e 73 74 3b 0d |saction)| const;.|
|000012d0| 0d 23 69 66 20 30 0d 09 | 76 69 72 74 75 61 6c 20 |.#if 0..|virtual |
|000012e0| 63 6f 6e 73 74 20 54 44 | 42 52 65 63 6f 72 64 2a |const TD|BRecord*|
|000012f0| 20 41 62 73 74 72 61 63 | 74 44 42 52 65 63 6f 72 | Abstrac|tDBRecor|
|00001300| 64 28 29 20 63 6f 6e 73 | 74 3b 0d 09 76 69 72 74 |d() cons|t;..virt|
|00001310| 75 61 6c 20 63 6f 6e 73 | 74 20 54 44 42 45 6c 65 |ual cons|t TDBEle|
|00001320| 6d 65 6e 74 2a 20 44 42 | 45 6c 65 6d 65 6e 74 52 |ment* DB|ElementR|
|00001330| 65 63 6f 72 64 28 29 20 | 63 6f 6e 73 74 3b 0d 09 |ecord() |const;..|
|00001340| 76 69 72 74 75 61 6c 20 | 63 6f 6e 73 74 20 54 44 |virtual |const TD|
|00001350| 42 50 72 6f 70 65 72 74 | 79 2a 20 44 42 50 72 6f |BPropert|y* DBPro|
|00001360| 70 65 72 74 79 52 65 63 | 6f 72 64 28 29 20 63 6f |pertyRec|ord() co|
|00001370| 6e 73 74 3b 0d 09 76 69 | 72 74 75 61 6c 20 63 6f |nst;..vi|rtual co|
|00001380| 6e 73 74 20 54 44 61 74 | 61 52 65 63 6f 72 64 2a |nst TDat|aRecord*|
|00001390| 20 44 61 74 61 52 65 63 | 6f 72 64 28 29 20 63 6f | DataRec|ord() co|
|000013a0| 6e 73 74 3b 09 0d 23 65 | 6e 64 69 66 0d 0d 09 76 |nst;..#e|ndif...v|
|000013b0| 69 72 74 75 61 6c 20 20 | 54 44 42 52 65 63 6f 72 |irtual  |TDBRecor|
|000013c0| 64 2a 20 41 62 73 74 72 | 61 63 74 44 42 52 65 63 |d* Abstr|actDBRec|
|000013d0| 6f 72 64 28 29 20 63 6f | 6e 73 74 3b 0d 09 76 69 |ord() co|nst;..vi|
|000013e0| 72 74 75 61 6c 20 20 54 | 44 42 45 6c 65 6d 65 6e |rtual  T|DBElemen|
|000013f0| 74 2a 20 44 42 45 6c 65 | 6d 65 6e 74 52 65 63 6f |t* DBEle|mentReco|
|00001400| 72 64 28 29 20 63 6f 6e | 73 74 3b 0d 09 76 69 72 |rd() con|st;..vir|
|00001410| 74 75 61 6c 20 20 54 44 | 42 50 72 6f 70 65 72 74 |tual  TD|BPropert|
|00001420| 79 2a 20 44 42 50 72 6f | 70 65 72 74 79 52 65 63 |y* DBPro|pertyRec|
|00001430| 6f 72 64 28 29 20 63 6f | 6e 73 74 3b 0d 09 76 69 |ord() co|nst;..vi|
|00001440| 72 74 75 61 6c 20 20 54 | 44 61 74 61 52 65 63 6f |rtual  T|DataReco|
|00001450| 72 64 2a 20 44 61 74 61 | 52 65 63 6f 72 64 28 29 |rd* Data|Record()|
|00001460| 20 63 6f 6e 73 74 3b 09 | 0d 0d 7d 3b 0d 0d 0d 23 | const;.|..};...#|
|00001470| 65 6e 64 69 66 0d 00 00 | 00 00 00 00 00 00 00 00 |endif...|........|
|00001480| 00 00 01 00 00 00 01 54 | 00 00 00 54 00 00 00 46 |.......T|...T...F|
|00001490| 3c 00 02 00 00 01 3d 00 | 1e 28 28 2a 20 28 73 68 |<.....=.|.((* (sh|
|000014a0| 6f 72 74 20 2a 29 20 30 | 78 30 41 30 41 29 20 3d |ort *) 0|x0A0A) =|
|000014b0| 18 54 72 61 6e 73 61 63 | 74 69 6f 6e 41 77 61 72 |.Transac|tionAwar|
|000014c0| 65 4f 62 6a 65 63 74 2e | 68 6e 02 00 00 00 54 45 |eObject.|hn....TE|
|000014d0| 00 00 54 45 58 54 4d 4d | 43 43 01 00 00 3c 00 c0 |..TEXTMM|CC...<..|
|000014e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014f0| 00 00 ac ba c0 85 00 00 | 13 f6 00 00 01 9a 07 30 |........|.......0|
|00001500| 78 41 30 37 35 00 00 00 | 01 41 00 00 00 07 30 78 |xA075...|.A....0x|
|00001510| 41 32 30 42 00 00 00 01 | 42 00 04 00 00 00 13 00 |A20B....|B.......|
|00001520| 00 01 43 00 00 01 44 00 | 14 28 2a 28 01 01 29 29 |..C...D.|.(*(..))|
|00001530| 28 28 01 02 29 2c 20 28 | 01 03 29 29 00 00 00 01 |((..), (|..))....|
|00001540| 45 00 00 00 07 30 78 41 | 30 38 42 00 00 00 01 46 |E....0xA|08B....F|
|00001550| 00 00 00 07 30 78 41 32 | 31 30 00 00 00 01 47 00 |....0xA2|10....G.|
|00001560| 00 00 07 30 78 41 41 33 | 37 00 00 00 01 48 00 00 |...0xAA3|7....H..|
|00001570| 00 07 30 78 41 39 42 32 | 00 00 00 01 49 00 01 00 |..0xA9B2|....I...|
|00001580| 00 00 00 48 00 09 4d 6f | 6e 61 63 6f 00 00 00 00 |...H..Mo|naco....|
|00001590| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015a0| 00 00 00 00 00 00 00 03 | 00 04 00 5b 00 13 01 cf |........|...[....|
|000015b0| 02 78 00 5b 00 13 01 cf | 02 78 ac a9 8f 1f 00 00 |.x.[....|.x......|
|000015c0| 12 51 00 00 12 56 00 00 | 0f 77 01 00 00 00 00 04 |.Q...V..|.w......|
|000015d0| 00 01 00 01 00 00 01 00 | 00 00 01 54 00 00 00 54 |........|...T...T|
|000015e0| 00 00 00 46 00 dc bc 88 | 21 0e 00 00 00 1c 00 46 |...F....|!......F|
|000015f0| 00 01 4d 50 53 52 00 00 | 00 12 4d 57 42 42 00 00 |..MPSR..|..MWBB..|
|00001600| 00 1e 03 ed ff ff 00 00 | 00 00 00 00 00 00 03 f0 |........|........|
|00001610| ff ff 00 00 00 4c 00 00 | 00 00 00 00 00 00 00 00 |.....L..|........|
|00001620| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001630| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001640| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001650| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001660| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001670| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+